home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / labeldisk.man < prev    next >
Text File  |  1991-09-27  |  4KB  |  91 lines
  1. ' $Header: /sprite/src/cmds/labeldisk/RCS/labeldisk.man,v 1.7 91/09/26 21:08:59 voelker Exp $ SPRITE (Berkeley)
  2. .so \*(]ltmac.sprite
  3. .HS LABELDISK cmds
  4. .BS
  5. .SH NAME
  6. labeldisk \- read and write a disk's label
  7. .SH SYNOPSIS
  8. .IP \fBlabeldisk 10
  9. [\fB\-from fromDevice\fR]
  10. [\fB\-w\fR]
  11. [\fB\-q\fR]
  12. [\fB\-sun\fR]
  13. [\fB\-dec\fR]
  14. [\fB\-new\fR]
  15. \fIdevice\fP
  16. .SH OPTIONS
  17. .IP \fB\-from\ fromDevice\fP
  18. Read the label from this device.
  19. .IP \fB\-w\fP
  20. Write a new label.
  21. .IP \fB\-q\fP
  22. Write a new label quickly, without prompting for partition information.
  23. .IP \fB\-sun\fP
  24. Write out a Sun label.  The default is to write whatever type of label was
  25. read.
  26. .IP \fB\-dec\fP
  27. Write out a Dec label.
  28. .IP \fB\-new\fP
  29. Ignore any old label.
  30. .IP \fIdevice\fP
  31. The device file with the disk label.  Without \fB-from\fP it is the
  32. device that the label is read from and written to, otherwise it is
  33. the device that is written to.
  34. .BE
  35.  
  36. .SH DESCRIPTION
  37. .LP
  38. This reads the disk label and verifies its checksum.  If the
  39. \fB-from fromDevice\fP option is present then the disk label is
  40. read from the \fBfromDevice\fP, and the \fBdevice\fP argument
  41. becomes the device to which the label is written to.
  42. .LP
  43. If the \fB\-w\fP
  44. option is present labeldisk interactively prompts for partition information.
  45. After this the user is presented with the new label and given
  46. the opportunity to commit the change or abort it.  The user is also
  47. given the chance to write the label to all of the valid partitions
  48. found on the device.  ``valid'' means that the partition has a positive
  49. number of cylinders associated with it, and that a file system
  50. exists on the partition.  If a partition on the
  51. disk is not ``valid'', then it is skipped.  An attempt is made to
  52. write the label to the raw disk in the improbable case that no
  53. valid partition starts on cylinder 0.  If labeldisk was not
  54. able to write the label to the raw disk or to a partition that
  55. begins at cylinder 0, then a warning is issued to that effect.
  56. .LP
  57. The \fB-q\fP option turns off the prompting for partition information
  58. only.  This is useful for copying a label from one partition
  59. on one device to other partitions on the same or different device
  60. if the user knows that the label on the from device has the
  61. correct information.  Overrides the \fB-w\fP option.
  62. .LP
  63. The \fB-dec\fP option converts the label being written to a dec label.
  64. .LP
  65. The \fB-sun\fP option converts the label being written to a dec label.
  66. .LP
  67. The \fB-new\fP option ignores any label read, and creates a new one
  68. instead.  If either the \fB-dec\fP or the \fB-sun\fP option is specified
  69. then the new label created is of the specified type.
  70. .LP
  71. Each disk is divided into 8 partitions, named ``ai'' thru ``gi''.
  72. Each partition is specified with a starting cylinder number and the
  73. number of cylinders it contains.  Unused partitions
  74. are indicated with a zero size.  Partitions can overlap, but
  75. overlapping partitions should never be used simultaneously!
  76. Traditionally partition ``ai'' is a small partition suitable for the root
  77. or a small /tmp.  Partition ``bi'' is a slightly larger system
  78. suitable for a single machine's swap directory.
  79. Partition ``ci'' is a single large partition that specifies the whole disk.
  80. Partitions ``di'' and ``ei'' are often used as large partitions
  81. beyond ``ai'' and ``bi''.
  82. Partition ``gi'' is usually set up as all the space after ``ai'' and ``bi''.
  83. Partitions ``fi'' and ``hi'' usually aren't used, but they can be.
  84. .LP
  85. Partitions are useful to quarantine different sets of users from
  86. one another, although they are a pain to change once a filesystem
  87. has been created on them.  Changing them requires recreating any affected
  88. filesystems. 
  89. .SH KEYWORDS
  90. disk, label
  91.